Framework / Formulas / Functions / Type Functions
In This Topic
    Type Functions
    In This Topic

     

    Syntax Description Example
    EMPTY() Returns the empty variant value.

    EMPTY()
    Returns: the empty variant

    ISARRAY(var) Returns true if the variant is array. Otherwise returns false.

    ISARRAY(ARRAY(10,20))
    Returns: true

    ISARRAY(10)
    Returns: false

    ISBOOL(var) Returns true if the variant is a boolean. Otherwise returns false.

    ISBOOL(true)
    Returns: true

    ISBOOL(false)
    Returns: true

    ISBOOL("true")
    Returns: false

    ISDATETIME(var) Returns true if the variant is a date time. Otherwise returns false.

    ISDATETIME(10)
    Returns: false

    ISDATETIME(DATE(2008,9,28))
    Returns: true

    ISEMPTY(var) Returns true if the variant is empty. Otherwise returns false.

    ISEMPTY(EMPTY())
    Returns: true

    ISEMPTY(true)
    Returns: false

    ISLENGTH(var) Returns true if the variant is a measure with unit from the length dimension.

    ISLENGTH(10)
    Returns: false

    ISLENGTH(10[mm])
    Returns: true

    ISMASS(var) Returns true if the variant is a measure with unit from the mass dimension.

    ISMASS(10)
    Returns: false

    ISMASS(10[kg])
    Returns: true

    ISMEASURE(var) Returns true if the variant is a measure of some kind.

    ISMEASURE(10)
    Returns: false

    ISMEASURE(10[kg])
    Returns: true

    ISMEASURE(10[rad])
    Returns: true

    ISNUM(var) Returns true if the variant is a number. Otherwise returns false.

    ISNUM(10)
    Returns: true

    ISNUM(true)
    Returns: false

    ISSTR(var) Returns true if the variant is a string. Otherwise returns false.

    ISSTR(true)
    Returns: false

    ISSTR("hello world")
    Returns: true

    ISTIME(var) Returns true if the variant is a measure with unit from the time dimension.

    ISTIME(10)
    Returns: false

    ISTIME(10[s])
    Returns: true

    TOBOOL(var) Safely converts a variant to a boolean variant. Returns EMPTY, if the conversion cannot be performed.

    TOBOOL("false")
    Returns: false

    TOBOOL("true")
    Returns: true

    TOBOOL("hello")
    Returns: the empty variant

    TODATETIME(var[,sCulture]) Safely converts a variant to a data time variant. Returns EMPTY, if the conversion cannot be performed.
    When strings a provided as argument they are by default parsed according to the current thread culture.
    If culture is provided the string is parsed according to that culture.

    DAY(TODATETIME("1/2/2008", "en-US"))
    Returns: 2

    DAY(TODATETIME("1/2/2008", "de-DE"))
    Returns: 1

    TONUM(var[,sCulture]) Safely converts a variant to a number variant. Returns EMPTY, if the conversion cannot be performed.
    When strings a provided as argument they are by default parsed according to the current thread culture.
    If culture is provided the string is parsed according to that culture.

    TONUM(true)
    Returns: 1

    TONUM("10")
    Returns: 10

    TONUM("hello")
    Returns: the empty variant

    TOSTR(var[,sCulture]) Safely converts a variant to a string variant. 
    The to-string conversion is by default performed according to the current thread culture. 
    If culture is provided the conversion is performed according to that culture.

    TOSTR(10.01, "en-US")
    Returns: "10.01"

    TOSTR(10.01, "de-DE")
    Returns: "10,01"

    TOSTR(DATE(2007,12,19), "en-US")
    Returns: "12/19/2007 12:00:00 AM"

    TOSTR(DATE(2007,12,19), "de-DE")
    Returns: "19.12.2007 00:00:00"

    See Also